home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / BDATA310.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-03-11  |  13.3 KB  |  308 lines
  1. BirdData 3.1 <ASP>
  2. Bird Breeders database/record-keeping program.
  3.  
  4. Print this file for program instructions.
  5.  
  6. ⌐1991-1996 All rights reserved
  7.  
  8.                           _______
  9. By Don Bradner       ____|__     |               (R)
  10. Arcata Pet        --|       |    |-------------------
  11. 600 F Street        |   ____|__  |  Association of
  12. Arcata, CA  95521   |  |       |_|  Shareware
  13.                     |__|   o   |    Professionals
  14.                   -----|   |   |---------------------
  15.                        |___|___|    MEMBER
  16.  
  17. Compuserve address: 76130,1007
  18. Internet: dbirdman@redshift.com
  19.  
  20. Contents of this file:
  21.  
  22.    A.  Note to users of BirdData 2.x
  23.    I.  Program Description
  24.   II.  Program Requirements
  25.  III.  Installation
  26.   IV.  Getting Started
  27.    V.  Files that make up BirdData
  28.   VI.  Troubleshooting
  29.  VII.  Getting future upgrades
  30. VIII.  Registration and distribution
  31.   IX.  ASP Ombudsman Statement
  32.  
  33. A. NOTE TO USERS OF BIRDDATA 2.X.
  34. This version of BirdData uses a completely different file 
  35. structure from previous versions.  It is possible to run 
  36. BirdData 3.0 and a previous version simultaneously without 
  37. harm.  It is recommended that version 3.0 be installed to a 
  38. completely different directory than 2.x, so that files don't 
  39. get "jumbled."
  40.  
  41. There is a conversion program included to convert 2.x files to 
  42. 3.0 format.  An option to run it will display during Setup if 
  43. an older version is detected.  The conversion program installs 
  44. to your BDATA3 directory along with the rest of the files, so 
  45. it may be run later.  If the conversion is run after data has 
  46. been entered in 3.0 format, THE NEW DATA WILL BE OVERWRITTEN.  
  47. Consequently, the conversion should only be done once.  Your 
  48. version 2.x data will not be disturbed by the conversion 
  49. process.
  50.  
  51. If you are a registered user of a version prior to 3.0 there is 
  52. no charge to upgrade.  If, after installing version 3 you see 
  53. the shareware "nag" screen, it means that the SETUP program did 
  54. not find the version 2 registration key.  You need to manually 
  55. copy the key (BDATAREG.KEY) from your version 2 directory or 
  56. the distribution diskette to the version 3 directory.  In most 
  57. cases SETUP will take care of this automatically.
  58.  
  59. I. PROGRAM DESCRIPTION.
  60. BirdData is a custom database for the types of records useful
  61. to bird keepers.  The program is oriented towards the
  62. needs of Parrot breeders, but may be useful to pet owners as
  63. well.
  64.  
  65. Bird records include identification information, fields for 6 
  66. items of user-defined data, and weight/journal for up to 2000 
  67. lines.  Weight information may be shown graphically for 
  68. individual birds and various groupings of birds.  Bird records 
  69. are placed in user-defined groups.
  70.  
  71. There is a search function for bird records that allows
  72. searching for a text string among any of the identification
  73. items or the six user-defined items.
  74.  
  75. A handy daily-weigh function will locate all babies that are a 
  76. specific age or less on a specific date, and allow weights and 
  77. comments for that date to be entered.  This is useful both for 
  78. daily entering of data, or for entering groups of paper-written 
  79. info maintained on a per day basis.
  80.  
  81. Pair data includes identification information, information on
  82. bird origins, free-form date-stamped diary entries, and ongoing
  83. egglaying data.  The program will calculate hatchdates, based
  84. on user input or prior data.
  85.  
  86. Pet data was maintained separately in previous versions, but is 
  87. integrated with the rest of the bird data in version 3.0.
  88.  
  89. Most records and lists may be printed to provide permanent
  90. records.
  91.  
  92. Full documentation is included in the form of a Windows Help
  93. file.  When you desire help, press your F1 function key for
  94. context-sensitive help, or press the help key if you are in a
  95. dialog box.
  96.  
  97. II. Program requirements.
  98.  
  99. BirdData requires an IBM compatible 286 or better, running
  100. Windows 3.1, with at least 4 megs of RAM.  A 386 with 8 megs or 
  101. more is recommended.  A mouse is required for some funtions.
  102. About 1 megs of hard-drive space is required to install, and each
  103. bird record will use about 2K of disk space initially and more 
  104. as the data increases.
  105.  
  106. III. Installation.
  107.  
  108. If you obtained BirdData by downloading it from a computer
  109. Bulletin Board (BBS) or another online source, one necessary
  110. file may not have been included.  You will need a file called
  111. VBRUN300.DLL, which is almost always available from any source
  112. that would have BirdData.  On BBS systems the file will
  113. usually be called VBRUN300.ZIP or VBRUN3.ZIP.  If you obtained
  114. the program on disk, the file should be included and may be
  115. called VBRUN300.DL_.  If it is missing, contact the supplier of
  116. the program.  Registered versions obtained from the author
  117. should always include VBRUN300.  If the file is included with
  118. the program it should be installed by the setup procedure; if
  119. it is independently obtained it should be unzipped and placed
  120. in your Windows\System Directory.
  121.  
  122. To install BirdData, insert the disk in your computer and
  123. choose File/Run from the Program Manager.  Enter A:Setup or
  124. B:Setup as appropriate and follow the prompts.  (If the program
  125. files are already in a directory on your hard disk, enter the
  126. appropriate path instead of A: or B:).
  127.  
  128. NOTE: Setup will not run if any other program is using 
  129. VBRUN300.DLL or any other library file used by the program.  An 
  130. error message will be generated, and you must end all such 
  131. applications before retrying the installation.  To be safe, it 
  132. is best to have only Windows running before installing BirdData 
  133. or any other program.
  134.  
  135. You may restart any other VBRUN300-using programs after 
  136. installation is complete.  Multiple programs may use the module 
  137. at once, with SETUP being an exception.
  138.  
  139. IV.  Getting Started.
  140.  
  141. The SETUP will create a "Bird" program group, with icons for 
  142. the program and the various text files.  Double-click the 
  143. BirdData icon to start the program.
  144.  
  145. The best way to familiarize yourself with the program elements 
  146. on screen is to click the help (question mark) icon, or choose 
  147. "Help" "Overview" from the menus.  In the helpfile's overview, 
  148. you may graphically choose different program elements to see an 
  149. explanation of their function.
  150.  
  151. Now click the "New Bird" icon (the "chick-in-shell").  Select a
  152. category and input a bird's information.  Don't worry about getting
  153. everything right; you can always edit it or delete the record later.
  154.  
  155. Add a couple of additional records, then try out the other
  156. program elements as they relate to those records.  When you are
  157. comfortable, you can convert any paper data you have to the
  158. BirdData format and begin to use the program on a daily basis.
  159.  
  160. V.  Files that make up BirdData.
  161.  
  162. The files are compressed on the disk.  They are listed here
  163. with their compressed and uncompressed names.  If you remove
  164. BirdData from your system, be careful about deleting any
  165. file with a .DLL or .VBX extension, since it might be used by
  166. another program (save a copy just in case).  The setup program
  167. only copies a file to your disk if it does not find the file
  168. already or if this file is newer.
  169.  
  170. References to the BDATA3 directory mean the directory you chose
  171. during installation for the program files.
  172.  
  173. Compressed      File Name        Type and where installed
  174.  
  175. BDATA3.EX_    BDATA3.EXE     Program, BDATA3 directory
  176. BDATA3.HL_    BDATA3.HLP     Helpfile, BDATA3 directory
  177. BDATA3.IN_      BDATA3.INI     Data file, BDATA3 directory
  178.                 SETUP.EXE      Setup Program, not transferred
  179.         SETUP.LST      Used by Setup
  180. SETUPBDT.EX_    SETUPBDT.EXE   BirdData Setup, Windows directory
  181.  
  182. VBRUN300.DL_    VBRUN300.DLL Library File, Windows\System directory
  183. ***note:  VBRUN300.DLL may not be included if the program was
  184. obtained from an online source.  It will have to be obtained to
  185. run the program and the setup program.  From on-line sources,
  186. it is usually VBRUN300.ZIP or VBRUN3.ZIP.  If the program was
  187. obtained on disk then the file should be included; if not,
  188. contact the source of the disk.  If the file is obtained
  189. separately, it must be installed in your Windows\System
  190. directory BEFORE you run setup.
  191.  
  192. VER.DL_        VER.DLL      Library File, Windows\System directory
  193. SETUPKIT.DL_    SETUPKIT.DLL     Ditto
  194. CMDIALOG.VB_    CMDIALOG.VBX     Ditto
  195. GRID.VB_        GRID.VBX         Ditto
  196. BDTLIBR.VB_     BDTLIBR.VBX      Ditto
  197.  
  198. BDATAREG.KEY    BDATAREG.KEY Registration key, BDATA3 directory
  199. ***Note: BDATAREG.KEY included only with registered versions.
  200.  
  201. ICONWRKS.EX_    ICONWRKS.EXE Icon Editor, BDATA3 directory
  202. ICONWRKS.HL_    ICONWRKS.HLP Help File, BDATA3 Directory
  203. ***Note: ICONWORKS included only with registered versions.
  204.  
  205. README.TXT     This file, BDATA3 directory
  206. WHATSNEW.TXT   Program history file, BDATA3 directory
  207.  
  208. *.IC_           *.ICO             Icon files, BIRDATA\ICONS
  209. subdirectory There are a number of custom icons included with
  210. BirdData; they were drawn by the author or by Sally Blanchard.
  211. Sally's all have a file name beginning with 'SB'.  You may use
  212. these as you wish, to replace the bird group icons in the
  213. program defaults.  There is also a blank icon included to use as a
  214. template for creating your own icons.  You will need an icon
  215. editor; there are many free and shareware editors available; 
  216. IconWorks is included with registered copies from the author 
  217. and is directly accessible from the Tools menu.
  218.  
  219. BirdData will make a one-line section addition to your WIN.INI
  220. file.  This entry tells the program the directory path to the
  221. program files.
  222.  
  223. BirdData will create a number of .REC files and .NDX files in
  224. your BDATA3 directory for the storage of data.  If you follow
  225. good backup procedures, these are the most important to
  226. backup, along with BDATA3.INI.
  227.  
  228. VI.  Troubleshooting.
  229.  
  230. Errors will frequently relate to a corrupted .INI file. You may 
  231. load BDATA3.INI into Windows Notepad or a similar text-only 
  232. editor and look for obviously bad entries.  Always make a 
  233. backup of the file before changing any entries, since it is 
  234. easy to make problems worse.
  235.  
  236. Some errors may be corrected by use of the Rebuild Indices menu 
  237. item in the Category menu.  If a specific record causes 
  238. problems all of the time, either restore a backup copy or else 
  239. delete the record and do an index Rebuild.  In the latter case 
  240. you would lose that record's data, which is a good reason to do 
  241. frequent backups.
  242.  
  243. VII.  Getting future Upgrades.
  244.  
  245. When you register BirdData with the author, you will receive a 
  246. copy of the latest version and a registration key that removes 
  247. the startup screen.  That key file will work with future 
  248. versions of the program, so no upgrade fee will be required.
  249.  
  250. Current versions of BirdData can always be found at the 
  251. author's internet FTP site: 
  252. ftp://redshift.com/arcatpet/bdata/bdataxxx.zip where xxx is the 
  253. version number.  There is also a jump available from the 
  254. author's web page at http://www.redshift.com/~arcatpet
  255.  
  256. Registered users who do not have online access may get a disk 
  257. copy from the author for a fee of $5 ($7 non-US).  Send a short 
  258. note indicating your registered status and requesting the 
  259. latest copy.  Please use the same name under which you are 
  260. registered.
  261.  
  262. VIII.  Registration and Distribution.
  263.  
  264. BirdData is shareware.  Free use is extended to any user for a 
  265. reasonable evaluation period;  typical idea of "reasonable" is 
  266. 30 days.  If use is continued, the program should be registered 
  267. with the author.  Registration fee is $25.  Registrants receive 
  268. a disk copy of the latest version of BirdData.  A convenient 
  269. form for registration is included below and in the Help file 
  270. (and may be printed from there).  Until you register, there 
  271. will be nag screens asking you to register, which you will 
  272. have to respond to.  When you register, this annoyance will go 
  273. away. Otherwise, this version is complete and un-crippled in 
  274. any way.  As a registration incentive, the author will provide 
  275. on request two free scanned images from your original prints or 
  276. slides, when sent with the registration.
  277.  
  278. Commercial use:  BirdData may be used commercially, as long
  279. as there is a registered copy for each computer/terminal that
  280. is using it.
  281.  
  282. You may freely distribute BirdData as long as no fees are
  283. charged for the program, and all necessary files are included.  
  284. Shareware services may charge their normal fees for 
  285. distribution of the disk, so long as it is clear to the 
  286. purchaser that they are not buying the program itself.
  287.  
  288. If you are a registered user, do not distribute the file
  289. BDATAREG.KEY, which identifies you as the user (This
  290. identification shows up in the startup logo and the About box).
  291.  
  292. The author is very interested in feedback from users.  Please
  293. feel free to make contact at the address shown at the beginning
  294. of this file with any comments/questions/problems.
  295.  
  296. IX. ASP Ombudman Statement
  297.  
  298. This program is produced by a member of the Association of Shareware 
  299. Professionals (ASP). ASP wants to make sure that the shareware 
  300. principle works for you. If you are unable to resolve a 
  301. shareware-related problem with an ASP member by contacting the member 
  302. directly, ASP may be able to help. The ASP Ombudsman can help you 
  303. resolve a dispute or problem with an ASP member, but does not provide 
  304. technical support for members' products. Please write to the ASP 
  305. Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 USA, FAX 
  306. 616-788-2765 or send a CompuServe message via CompuServe Mail to ASP 
  307. Ombudsman 70007,3536
  308.